home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / route.z / route
Encoding:
Text File  |  1998-10-20  |  12.4 KB  |  265 lines
  1.  
  2.  
  3.  
  4. RRRROOOOUUUUTTTTEEEE((((1111MMMM))))                                                            RRRROOOOUUUUTTTTEEEE((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      route - manually manipulate the routing tables
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////rrrroooouuuutttteeee [----nnnnqqqqffffFFFF] _c_o_m_m_a_n_d [[_m_o_d_i_f_i_e_r_s] _a_r_g_s]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _R_o_u_t_e is a utility used to manually manipulate the network routing
  16.      tables.  It normally is not needed, as a system routing table management
  17.      daemon such as _r_o_u_t_e_d(1M), should tend to this task.
  18.  
  19.      The _r_o_u_t_e utility supports a limited number of general options, but a
  20.      rich command language, enabling the user to specify any arbitrary request
  21.      that could be delivered via the programmatic interface
  22.  
  23.      ----nnnn  Bypasses attempts to print host and network names symbolically when
  24.          reporting actions.  (The process of translating between symbolic
  25.          names and numerical equivalents can be quite time consuming, and may
  26.          require correct operation of the network; thus it may be expedient to
  27.          forgo this, especially when attempting to repair networking
  28.          operations),
  29.  
  30.      ----vvvv  (verbose) Print additional details.
  31.  
  32.      ----qqqq  Suppress all output.
  33.  
  34.      ----FFFF  Flush all entries, not just gateway entries, usually when restarting
  35.          the system.  Note that unless at least some of the major non-gateway
  36.          routes are immediately restored, the system will not work.
  37.  
  38.      The _r_o_u_t_e utility provides six commands:
  39.  
  40.      aaaadddddddd       Add a route.
  41.  
  42.      fffflllluuuusssshhhh     Remove all 'gateway' routes.  Non-gateway routes are added by
  43.                device drivers when the interface is configured, and so should
  44.                usually not be removed.
  45.  
  46.      ddddeeeelllleeeetttteeee    Delete a specific route.
  47.  
  48.      cccchhhhaaaannnnggggeeee    Change aspects of a route (such as its gateway).
  49.  
  50.      ggggeeeetttt       Lookup and display the route for a destination.
  51.  
  52.      mmmmoooonnnniiiittttoooorrrr   Continuously report any changes to the routing information
  53.                base, routing lookup misses, or suspected network
  54.                partitionings.
  55.  
  56.      The monitor command has the syntax
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RRRROOOOUUUUTTTTEEEE((((1111MMMM))))                                                            RRRROOOOUUUUTTTTEEEE((((1111MMMM))))
  71.  
  72.  
  73.  
  74.          rrrroooouuuutttteeee [----nnnn] mmmmoooonnnniiiittttoooorrrr
  75.  
  76.      The flush command has the syntax
  77.  
  78.           rrrroooouuuutttteeee [----nnnn] [----FFFF] fffflllluuuusssshhhh
  79.  
  80.      If the fffflllluuuusssshhhh command is specified, rrrroooouuuutttteeee will ``flush'' the routing
  81.      tables of all gateway entries.  The ----FFFF flag flushes all entries are
  82.      deleted.
  83.  
  84.      The other commands have the following syntax:
  85.  
  86.          rrrroooouuuutttteeee [----nnnn] _c_o_m_m_a_n_d [----nnnneeeetttt | ----hhhhoooosssstttt]  _d_e_s_t_i_n_a_t_i_o_n _g_a_t_e_w_a_y
  87.  
  88.      where _d_e_s_t_i_n_a_t_i_o_n is the destination host or network, _g_a_t_e_w_a_y is the
  89.      next-hop intermediary via which packets should be routed.  Routes to a
  90.      particular host may be distinguished from those to a network by
  91.      interpreting the Internet address specified as the _d_e_s_t_i_n_a_t_i_o_n argument.
  92.  
  93.      _d_e_s_t_i_n_a_t_i_o_n may be specified with the keyword ``default'' (instead of an
  94.      IP address or name) to specify a route to all possible destinations; this
  95.      is the route of last resort, used by the system if no better match is
  96.      found.
  97.  
  98.      Configuring a static default route is often useful if there is only one
  99.      path available to get traffic out of the local subnet.  This can be
  100.      accomplished easily by adding the route to ////eeeettttcccc////ccccoooonnnnffffiiiigggg////ssssttttaaaattttiiiicccc----
  101.      rrrroooouuuutttteeee....ooooppppttttiiiioooonnnnssss.
  102.  
  103.      The optional modifiers nnnneeeetttt and hhhhoooosssstttt force the destination to be
  104.      interpreted as a network or a host, respectively.  Otherwise, if the
  105.      _d_e_s_t_i_n_a_t_i_o_n has a ``local address part'' of INADDR_ANY , or if the
  106.      _d_e_s_t_i_n_a_t_i_o_n is the symbolic name of a network, then the route is assumed
  107.      to be to a network; otherwise, it is presumed to be a route to a host.
  108.  
  109.      For example, 128.32 is interpreted as ----hhhhoooosssstttt 128.0.0.32 ; 128.32.130 is
  110.      interpreted as ----hhhhoooosssstttt 128.32.0.130; ----nnnneeeetttt 128.32 is interpreted as
  111.      128.32.0.0; and ----nnnneeeetttt 128.32.130 is interpreted as 128.32.130.0.
  112.  
  113.      If the destination is directly reachable via an interface requiring no
  114.      intermediary system to act as a gateway, the ----iiiinnnntttteeeerrrrffffaaaacccceeee modifier should
  115.      be specified; the gateway given is the address of this host on the common
  116.      network, indicating the interface to be used for transmission.
  117.  
  118.      The optional ----nnnneeeettttmmmmaaaasssskkkk qualifier is intended to achieve the effect of an
  119.      OSI ESIS redirect with the netmask option, or to manually add subnet
  120.      routes with netmasks different from that of the implied network interface
  121.      (as would otherwise be communicated using the OSPF or ISIS routing
  122.      protocols).  One specifies an additional ensuing address parameter (to be
  123.      interpreted as a network mask).  The implicit network mask generated in
  124.      the AF_INET case can be overridden by making sure this option follows the
  125.      destination parameter.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RRRROOOOUUUUTTTTEEEE((((1111MMMM))))                                                            RRRROOOOUUUUTTTTEEEE((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      Routes have associated flags which influence operation of the protocols
  141.      when sending to destinations matched by the routes.  These flags may be
  142.      set (or sometimes cleared) by indicating the following corresponding
  143.      modifiers:
  144.  
  145.           -cloning   RTF_CLONING    - generates a new route on use
  146.           -xresolve  RTF_XRESOLVE   - emit mesg on use (for external lookup)
  147.           -iface    ~RTF_GATEWAY    - destination is directly reachable
  148.           -static    RTF_STATIC     - manually added route
  149.           -nostatic ~RTF_STATIC     - pretend route added by kernel or daemon
  150.           -reject    RTF_REJECT     - emit an ICMP unreachable when matched
  151.           -blackhole RTF_BLACKHOLE  - silently discard pkts (during updates)
  152.           -proto1    RTF_PROTO1     - set protocol specific routing flag #1
  153.           -proto2    RTF_PROTO2     - set protocol specific routing flag #2
  154.           -llinfo    RTF_LLINFO     - validly translates proto addr to link addr
  155.  
  156.  
  157.      The optional modifiers ----rrrrtttttttt, ----rrrrttttttttvvvvaaaarrrr, ----sssseeeennnnddddppppiiiippppeeee, ----rrrreeeeccccvvvvppppiiiippppeeee, ----mmmmttttuuuu,
  158.      ----hhhhooooppppccccoooouuuunnnntttt, ----eeeexxxxppppiiiirrrreeee, and ----sssssssstttthhhhrrrreeeesssshhhh provide initial values to quantities
  159.      maintained in the routing entry by transport level protocols, such as TCP
  160.      or TP4.  These may be individually locked by preceding each such modifier
  161.      to be locked by the ----lllloooocccckkkk meta-modifier, or one can specify that all
  162.      ensuing metrics may be locked by the ----lllloooocccckkkkrrrreeeesssstttt meta-modifier.
  163.  
  164.      In a cccchhhhaaaannnnggggeeee or aaaadddddddd command where the destination and gateway are not
  165.      sufficient to specify the route (as in the case where several interfaces
  166.      may have the same address), the ----iiiiffffpppp or ----iiiiffffaaaa modifiers may be used to
  167.      determine the interface or interface address.
  168.  
  169.      All symbolic names specified for a _d_e_s_t_i_n_a_t_i_o_n or _g_a_t_e_w_a_y are looked up
  170.      first as a host name using ggggeeeetttthhhhoooossssttttbbbbyyyynnnnaaaammmmeeee(3).  If this lookup fails,
  171.      ggggeeeettttnnnneeeettttbbbbyyyynnnnaaaammmmeeee(3) is then used to interpret the name as that of a network.
  172.  
  173.      RRRRoooouuuutttteeee uses a routing socket and the new message types RTM_ADD,
  174.      RTM_DELETE, RTM_GET, and RTM_CHANGE.  As such, only the super-user may
  175.      modify the routing tables.
  176.  
  177. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  178.      aaaadddddddd [[[[hhhhoooosssstttt |||| nnnneeeettttwwwwoooorrrrkkkk ]]]] %%%%ssss:::: ggggaaaatttteeeewwwwaaaayyyy %%%%ssss ffffllllaaaaggggssss %%%%xxxx
  179.          The specified route is being added to the tables.  The values printed
  180.          are from the routing table entry supplied in the iiiiooooccccttttllll(2) call.  If
  181.          the gateway address used was not the primary address of the gateway
  182.          (the first one returned by ggggeeeetttthhhhoooossssttttbbbbyyyynnnnaaaammmmeeee(3), the gateway address is
  183.          printed numerically as well as symbolically.
  184.  
  185.      ddddeeeelllleeeetttteeee [[[[ hhhhoooosssstttt &&&&|||| nnnneeeettttwwwwoooorrrrkkkk ]]]] %%%%ssss:::: ggggaaaatttteeeewwwwaaaayyyy %%%%ssss ffffllllaaaaggggssss %%%%xxxx
  186.          As above, but when deleting an entry.
  187.  
  188.      %%%%ssss %%%%ssss ddddoooonnnneeee
  189.          When the fffflllluuuusssshhhh command is specified, each routing table entry deleted
  190.          is indicated with a message of this form.
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. RRRROOOOUUUUTTTTEEEE((((1111MMMM))))                                                            RRRROOOOUUUUTTTTEEEE((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      NNNNeeeettttwwwwoooorrrrkkkk iiiissss uuuunnnnrrrreeeeaaaacccchhhhaaaabbbblllleeee
  207.          An attempt to add a route failed because the gateway listed was not
  208.          on a directly-connected network.  The next-hop gateway must be given.
  209.  
  210.      nnnnooootttt iiiinnnn ttttaaaabbbblllleeee
  211.          A delete operation was attempted for an entry which wasn't present in
  212.          the tables.
  213.  
  214.      rrrroooouuuuttttiiiinnnngggg ttttaaaabbbblllleeee oooovvvveeeerrrrfffflllloooowwww
  215.          An add operation was attempted, but the system was low on resources
  216.          and was unable to allocate memory to create the new entry.
  217.  
  218. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  219.      netintro(7), routed(1M).
  220.  
  221. BBBBUUUUGGGGSSSS
  222.      The first paragraph may have slightly exaggerated rrrroooouuuutttteeeedddd's abilities.
  223.  
  224. FFFFIIIILLLLEEEESSSS
  225.      /etc/config/static-route.options   static route configuration file
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.